Skip to content

docs: reproducible README hero video pipeline - #86

Open
tig wants to merge 2 commits into
mainfrom
docs/hero-video-pipeline
Open

tig wants to merge 2 commits into
mainfrom
docs/hero-video-pipeline

Conversation

@tig

@tig tig commented Jul 24, 2026

Copy link
Copy Markdown
Owner

Summary

  • Adds docs/hero-video/ so the README hero video (silico × xuss first ship) can be produced and re-cut reproducibly.
  • Includes narrative script, capture checklist, timeline.toml edit decision list, and build.py (ffmpeg) with session-elapsed clock, speed ramps, open still from docs/hero.jpg, and end card for https://github.com/tig/silico.
  • Host tests cover timeline load + placeholder smoke encode; raw footage/renders stay gitignored.

Script beats (operator)

  1. Opening hero.jpg + clock at 0:00
  2. GH silico → Getting Started prompt highlight
  3. Terminal: clone xuss, start grok, paste prompt
  4. Welcome slow for readability
  5. Time-lapse first ship, slow on human gates
  6. Desk metal: boot sound + product face demo
  7. tig/xuss CI green
  8. End card: https://github.com/tig/silico

How to use

python docs/hero-video/build.py --placeholders   # smoke
# drop clips into docs/hero-video/footage/ per record.md
python docs/hero-video/build.py --check-footage
python docs/hero-video/build.py

Publish the rendered out/hero.mp4 as a release asset (or similar), then link from README using the existing hero still as poster — documented in docs/hero-video/README.md.

Test plan

  • pytest tests/test_hero_video_build.py
  • python docs/hero-video/build.py --placeholders produces docs/hero-video/out/hero.mp4
  • After merge: record footage per record.md, tune timeline.toml, render final, host asset, embed in README

Add docs/hero-video with storyboard, capture checklist, timeline.toml,
and an ffmpeg assembler that burns a first-ship session clock, applies
per-segment speed (time-lapse / slow-mo), generates open/end cards from
hero.jpg, and supports --placeholders for smoke builds without footage.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 87189268d7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/hero-video/build.py
Comment on lines +530 to +531
# Trim source read length (pre-speed); setpts shortens the output timeline.
args.extend(["-t", f"{raw:.4f}"])

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Do not truncate slow-motion clips at their raw duration

-t appears after the input URLs, so FFmpeg applies it to the output rather than limiting input decoding. For any speed < 1 clip this caps the encoded clip at raw seconds instead of its intended raw / speed duration; the default welcome-slow segment is therefore cut to 8 seconds rather than approximately 22.9 seconds, and its clock cannot reach the configured 2:30 endpoint. Limit the input before -i, or use out_dur as the output limit.

Useful? React with 👍 / 👎.

Prefer MCEC for browser/terminal/agent/CI capture (record GIF + agent drive),
matching mcec/WinPrint hero recipes. Desk metal stays camera. Document GIF
duration limits, segmented takes, and point timeline sources at .gif files.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant